i: 



Orion Micro Systems 

Copyright (c) 1988 


m 


Features 


* 32 Message Bases 

* 32 File SIG Areas w I file descriptions 

* 32 Command Sec Levels 
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* Full Online User Editor 
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BBS Express! PRO gives you the 
power you always dreamed of la an 
Atari 8-hlt BBS. With over 200K of 
code, the only limitation you will 
encounter Is your imagination. 

Write your own games, utilities, or 
user functions. Included doc's show 
you how. 

Express! PRO allows over 1/2 
million files to he online at the 
same time. 

Link up with other Express! PRO 
hoards across the country and your 
users can talk to long distance 
users right from your BBS. 
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BBS Express! Prof emaional 
(c)1988 Orion Micro Systems 

Introduction 

Welcome to BBS Express! Professional. Us think you will find this 
BBS to bo tho most powerful mvr written For the Atari 8-bit line of 
computers. 

Us know you ars anxious to got tha board up and running, but please 
take the time to read through the manual completely before 
confinure the board. An overall understanding of how the board is set up 
and how it runs will help you when it comes time to decide where to put 
things on your drives. 

Throughout this manual, we will refer to SpartaDOS's command 
structure with the understanding that you ars familiar with how to use 
SpartaDOS. Ue won't attempt to teach you how to use SpartaDOS within 
the context of this manual. Assuming you have a working knowledge of the 
DOS, you should have no trouble setting up and running the BBS. If you 
are a novice SpartaDOS user, keep your SpartaDOS manual handy for quick 
reference. 

Ue will be maintaining an 'Official' Pro Support board _f° r j the 
exclusive use of registered owners. The phone number is 
You may call in Atascii or Ascii at 300, 1200 or 2400 baud. After 

registering on the board, you will be disconnected. You may call back 
the next day and will have been validated by then. TM* i * cm ^ 

will have placed on it any upgrades to the various modules as well 
new modules as they ara written. 

Thanks again for purchasing BB8 Express! Professional. Drop us a 
line if you would like to see something added to the board that would b 
of benefit to the majority of sysops running the U " \ 

adding commands and upgrading the program from time to time, so chec k-in 
with the support board periodically for the latest news on improvements. 
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System Requirements 


BBS Express! PRO’S power is made passible by tailoring the program 
to a specific CPU group and a specific DOS. You must use SpartaDOS 3.2 
in order to run BBS Express! PRO. We cannot sag at this writing if 
the yet-to-be-rBiassed SpartaDos X cartridge can ba used with PRO. 
Assuming the cartridge is totally compatible with 3.2, it will work. 
By tho vary nature of SpartaDOS, you are limited to using an Atari 0OOXL 
or 130XE. PRO will not run on an BOO due to the fact that SpartaDOS 
won't run on it. Any memory upgrade available for the BOOXL or 130XE 
should work with PRO as long as you Install your ramdlsk handler before 
running the BBS program. 

If you own the RtimeB clock cartridge, PRO will take full advantage 
of it. If you don't own one, you will need to set the SpartaDOS software 
clock before running PRO. In either case, the TDLINE.COM file should be 
run prior to running the board. 

Ue recommend using a hard drive to run PRO, but it isn’t absolutely 
necessary. PRO’S commands are loaded into memory as required, so the 
slower your storage device, the longer it will take to load in these 
commands. The best solution, Bven when running with a hard drive,is to 
keep the BBS’s command subdirectory on the ramdisk. This will afford the 
best response time to the user. 

BBS Express! PRO’S shell loads into memory at S3000. This is the 
portion of the BBS that always remains in memory and has control most of 
the time. You must load the RS232.COM and TDCINE.COM from the SpartaDOS 
disk, along with the BBBPREP.CMD file from your Pro disk, before 
PRO will run. These can ba Included in your STARTUP.BAT file. Optimally, 
you should have room to load your favorite accessories Csuch as a ram¬ 
disk handler) as long as MEML0 goes no higher than S3000. The 
BBSPREP.CMD file must ba the last file that alters MEf1L0 to be loaded. 

Any Hayes compatible modem can be used with BBS Express! PRO. How 
Hayes compatible? tiiall... the modem must be able to answer the phone 
with an ATA command and must be able to hang up the phone when the DTR 
line drops low. Not too much to ask a BBS modem to do. If you have a 
modem that uses the extended command set, PRO will auto-detect the 
callers baud rate by detecting the CONNECT, CONNECT 1200 and CONNECT 
2400 messages returned by modem. 
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What’s On Ths Disks 

BBS ExpressI PRO is shipped to you on 2 single density disks 


Disk 1 contains: 

Front Side BBS.COM 

BBSPREP.COM 

SYSEDIT.COM 

MAKEULOG.COM 

MAKEMSGB.COM 

UEXTEND.COM 

MAKESUB.BAT 

Back Side Oata> 

HelpH0> 

Help80> 


- the BBS shell module. 

- prepares system to run BBS. 

- the syseditor. 

- userlog creation program. 

- message base creation program. 

- extends the size of the userlog 

- create subdirectory batch file. 

- Data Files For support programs. 

- All the atascii and ascii help 
Files For HO column users. 

- All the atascii and ascii help 
Files For 80 column users. 


Disk 2 contains: 
Front 8 Back 


All the system command modules that are 
required For PRO to run.These should be placed 
in the PR0>C0MMANDS> subdirectory on your hard 
drive and ramdisk. 


Command Modules 


ATASCII CMD BROWSE 

CMD - DOSSHELL 

- FEEDBACK CMD "FILESTAT 

— GOODBYE CMD LOGIN 

LOGON CMD LOGOUT • 

MSGBASE CMD NETCALL 

NETPREP CMD NETUPDT 

. PARMEDIT CMD READMAIL 

SENDMAIL CMD "UEDITOR 
•ULPRINT CMD "ULPURGE 
USHELL CMD "UDEL 
UIAITCALL CMD "WHEREIS 
WHOMAINT CMD "XMODEM 


CMD CALLSYS CMD 
CMD "EDITFILE CMO 
CMD FINDFILE CMD 
CMD LOGOFF CMD 
CMD MAIN CMD 
CMD "NETEDIT CMD 
CMD —"NEWFILES CMD 
CMD — SCANMARK CMO 
CMD "ULBACKUP CMD 

CMD .-USEARCH CMD 

CMD "UIEWEUNT CMD 
CMD WHOCALL CMD 
CMD 


NOTEi Commands with an beside them are intended 

to be ’Sysop Commands’ to either be run From 
the Dos Shell or the Event Scheduler. 


The Following topics are organized in such 
is perFormed beFore proceeding to the next. 


manner that each step 
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The System Directories 


BBS ExpressI PRO uses subdirectories extensively. The entire board 
and all its files reside under one subdirectory in the main directory. 
To illustrate this, look at the diagram below. This pictorlally 
represents how PRO’S subdirectories are structured. 

+-+ 

I PRO I 


t 


-+-+-+---+-+-+-♦-* 

I I I I I I I 1 1 

+ _ +♦-++-+♦-++---♦+-♦+--* 

I BASES tICOMMANDS!!DATA IIHELP40IIHELPBOII LOB I I NETWORK!!UPLOADS IIUSERLOGI 

+ _ ++-++-++-♦♦---++- - -*♦- + 

Subdirectory Purpose 


+— IFILES-O1I--IF001I--THRU--IF127I ' BASES 

+-+ +-♦ +-+ connANDS 

I I DATA 

*-+ +-♦ HELP40 

IDESCI IDESCI HELPBO 

+-♦ +- * LOG 

NETWORK 

+-* +-+ --♦ if UPLOADS 

■I FILES—321 — IF0011 —THRU— IF127I { USERLOB 

+-♦ +-♦ +- +4 FILES-XX 

I I 


IDESCI 
♦——+ 


IDESCI 


stores message bases 
stores BBS commands 
stores module data files 
40 column help menus 
80 column help menus 
stores BBS log files 
stores network data files 
stores new upload files 
stores userlog 
stores downloads 


As you can see, each of these subdirectories reside under the 
subdirectory called PRO in the main directory. While each of_ these 
subdirectories may physically reside on the same drive, they don t have 
to. You can put the COMMANDS directory on drive B and the UPLOAD 
directory on drive 2 and the FILES-XX subdirectories on drives 4, 5 and 
B. The key to doing this is that each drive that you will be using with 
the BBS has a subdirectory called PRO defined in the main directory of 
that drive and the BBS subdirectories reside in this PRO subdirectory. 


To make the task of creating these subdirectories easier, we have 
provided a batch file on the master disk called MAKESUB.BAT which will 
create all the necessary subdirectories for you. You must edit this 
batch file with a text editor and change the drive numbers to the drive 
where you want the various subdirectories located. This batch file will 
also make the first three subdirectories required for the first three 
download file areas. You may adjust this to your own requirements prior 
to running the batch file, depending on how many download file areas you 
are setting up For your system. 

After you have created all the directories, it is recommended that 
you copy the files contained on the master disks to the appropiate 
subdirectories you just created. The master disks contain all the files 
within the subdirectories where they should reside, so a wildcard 
subdirectory copy is acceptable. Make yourself a list of where you 
decided to place the subdirectories. This will aid you in the next step 
of creating the SYSDATA.DAT file. 
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Creating Tha Sysdata.Dat File 

The SYSDATA file contains all the system parameters that PRO needs 
to know where to find things. This file Is created and maintained using 
the Syseditor program which is discussed in detail below. 

Sysdata Editor 

The Sysedit.Coe utility is a stand alone program which is used to 
create and later edit the Sysdata.dat file. This file contains all ths 
system data parameters which BBS ExpressI Professional uses to determine 
where required system files are located and how to configure the system 
setup. Using the program is prstty intuitive, but a detailed explanation 
of the various options is provided below. 

Sysedit.Coe is loaded from the SpartaDOS command prompt by typing 
SYSEDIT and pressing return. Make sure that BASIC It. dtublfd- u * Bn the 
program finishes loading, you will be prompted to enter a drive number 
for the SYSDATA.DAT file. If SYSEDIT can not find the sysdata file on 
that drive, you will be prompted with 'Create A Wee Sysdata ?'. Respond 
Yes or No. No will exit back to the DOS prompt and Yes will initialize 
a new sysdata file for edltting. When you exit the Syseditor (Option 3 
from Main Menu), you will be prompted for a filename to save the 
configuration or hit return to save under the displayed input filename. 
The SYSDATA.DAT file should alttays be saved in the PRO subdirectory an 
the drive that you plan to boot the board from using the name 
SYSDATA.DAT. 

After specifying the drive number for the Sysdata.dat file, thB 
Main Menu will appear and allow the following options: 

Main Menu 

Cl) System Parameters 
C23 Drive Parameters 
C33 Main Commands 
C43 File Slg Parameters 
CS3 System Baud Rates 
CB3 Misc. Parameters 
C73 ExpressNET Parameters 
CS3 Event Scheduler 
CS3 Exit Susdata Editor 

Each of these options is discussed below. An asterisk will appear 
to the left of the menu number if you have entered that option during 
this editing session. Uhils in any option 1-B, you may return to the 
Main Menu by pressing the Escape Key. 
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C13 Bvatam Pir«a»t»rai CA] 

CB3 

CCD 

CD] 

CE] 

CF] 

CG] 
CH3 


System Hi Message.... 

S33SS 

Total System Calls... 

33333 

Calls Today. 

39393 

Feedback Mode. 

xxxxxx 

Allow Handles. 

XXX 

Interface Type. 

XXX 

Use File Sig Desc. . . . 

XXX 

Secondary Password 
xxxxxxxxxxxxxxx 

Board Name For Status 

Line 


Cl] 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 
CJ] Sysop Name For Status Lina 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


CA] Syataa Hi Haaaage - This is tha Hi message counter. IF you 
are Just starting out with PRO, this Field should be sat to 
1. Tha board increments this number For each massage or 
E-mail posted on tha system. Press return aFtar entering a 
new value. 


CB] Total Calls - Total system calls to date that your BBS has 

received. IF Just starting a BBS, this number should be leFt 
zero. Otherwise, speciFy your current system calls in this 
Field. Press return aFter entering a new value. 


CC3 Calls Today - Total calls your system has received today. 

Press return aFter entering a new value. 

CD3 Feedback Mode - SpeciFies whether the system will direct 
sysop Feedback to Email or is turned oFF. This Field is 
toggled by hitting the option letter. 

CE] Allow Handles - This Field toggles between YES and NO. It is 
used to speciFy whether you want to allow the use oF handles 
on your system. 

CF] Interlace Type - This Field toggles between rUO, PRC and B50. 
Set to the interFace type that you are using. 

CG] Use File Sig Desc - This Field toggles between YES and NO. 
SpeciFies whether you want to use descriptions with download 
Files or not. 

CH] Secondary Password - SpeciFies the current sysop level 
password. This Field may be up to 15 characters. Any user with 
sysop access will be required to enter this password when 
accessing the system remotely. When Finished editing this 
Field, press return. 

Cl] Board Name for Status Line - SpeciFies a string oF up to 3B 

characters For board name which will display in the top status 
line while the board is running. This Field is automatically 
centered when editing is terminated with a return. 

CJ] Sysop Name for Status Line - SpeciFies a string of up to 36 

characters For sysop namB which will display in the top status 
line while the board is running. This Field is automatically 
centered when editing is terminated with a return. 
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t23 Drive PirawtitM 


CAD UserLog Orivo. Dx: 

CBD HelpHO Drive. Dx: 

CCD HelpDO Drive. Dx: 

CDD Command Drive. Dx: 

CE3 System Log Drive. Dx: 

CFD System Data Drive- Dx: 

CGD Upload Drive. Dx: 

CHD Msg Bases Drives 

.—+- 1 -+-2-+-3-E 


00000000000000000000000000000000 
CID File Sig Drives 

-+- 1 -- 2 -+- 3 — 

00000000000000000000000000000000 


CAD thru CGD - These options are used to specify the drive number 
uhera each of the required system directories may be found. 

To change drive numbers, press the letter which you wish to 
change until the drive number you want appears on the 
screen. 

NOTEi Option E allows the drive to be set to 0. If the Log 
Drive is set to 0, this will turn OFF the logging of 
callers to the call log. 

CHD Message Base Drives - Specifies the drive number where each 
message base may be found. Enter a drive number (1 - B) For 
each active message bass. If a message base does not exist or 
is currently Inactive, specify a 0 drive number. 

CID File Sig Drives - Specifies the drive number where each file 
SIG may be be found. Enter a drive number Cl - 8) for each 
active file SIG. If a file SIG does not exist or is currently 
inactive, specify a 0 drive number. 


CPage 7D 










C33 Main Commandsi 

Num 

Key 

Lvl 

Typ 

.CMD 


#01 

X 

0 

X 

XXXXXXXX 


#05 

X 

0 

X 

XXXXXXXX 


#03 

X 

0 

X 

XXXXXXXX 


#04 

X 

0 

X 

XXXXXXXX 


#05 

X 

0 

X 

XXXXXXXX 


#05 

X 

0 

X 

XXXXXXXX 


#07 

X 

0 

X 

XXXXXXXX 


#08 

X 

0 

X 

XXXXXXXX 


#03 

X 

0 

X 

XXXXXXXX 


#10 

X 

0 

X 

XXXXXXXX 


#11 

X 

0 

X 

XXXXXXXX 


#15 

X 

0 

X 

XXXXXXXX 

The Main Command 

screen i 

displays up to 

35 main command definitions 


in a scolling manner, llaa the Up/Down arrows to move up and down the 
commands. When the bottom command is reached and the down arrow is hit 
again, the next page of commands will appear. Likewise, when the hl- 
light bar reaches the top command, the previous page will appear, except 
if you are at the top of page 1. Position the hi-light bar at the 
command you wish to edit and press return. You may now change the 
information which pertains to that command. Each command entry consists 
of four pieces of information. 

Key - Specifies the Key definition. This defines the key as a 

valid entry from the main command prompt. A dash specifies 
unused command entries. Any character may be used except dash 
to specify a valid key. If a dash is keyed, the command is 
reset to an Invalid command. 

Lvl - A value between 0 and 35 to specify the security level 

required to access this key function. Natal 32 is sysop level. 
This field corresponds to the user’s "Command Security Level 
settings. Example: If you set a command to level 3, the user’s 
command level 3 flag would have to be turned on for them to be 
able to execute the function. 

Typ - Specifies the type of file that is contained in the .CMD 

field. Hitting return on this field will default to type C. 

C - denotes that this is a command (executable .cmd file!. 

T - denotes that this is a text or menu file to be displayed. 

.CMD - Specifies the filename (no extender) which will be viewed 

or executed if the key is pressed by the user. If only return 
is pressed on this field, the command edit is aborted and the 
original command will reappear unchanged. 
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C43 File S ta P»r»«tt«r»l 


Num Fils Sig Name 

#01 xxxxxxxxxxxxxxxxxxxx 
#02 xxxxxxxxxxxxxxxxxxxx 
#03 xxxxxxxxxxxxxxxxxxxx 
#04 xxxxxxxxxxxxxxxxxxxx 
#05 xxxxxxxxxxxxxxxxxxxx 
#06 xxxxxxxxxxxxxxxxxxxx 
#07 xxxxxxxxxxxxxxxxxxxx 
#08 xxxxxxxxxxxxxxxxxxxx 
#09 xxxxxxxxxxxxxxxxxxxx 
#10 xxxxxxxxxxxxxxxxxxxx 
#11 xxxxxxxxxxxxxxxxxxxx 
#12 xxxxxxxxxxxxxxxxxxxx 


Thu Filo Slg screen displays up to 32 file sig definitions in a 
scrolling manner. Use the Up/Down arrows to move up and douin the file 
sigs. When the bottom file sig is reached and down arrow is hit again, 
the next page of file sigs will appear. Likewise, when the hi-light bar 
reaches the top file sig, the previous page will appear, except when on 
page 1. To edit any file sig entry, position the hi-light bar at the 
file sig you wish to edit and press return. You may now change the file 
sig name. Pressing return without keying any change will leave the 
original slg name intact and unchanged. After editing the file sig name, 
press return to terminate editing. Each file sig name may have up to 20 
characters. Editing automatically ends if you enter your 20th character, 
so a return would not be necessary in that case. 


C33 System Baud Rates» 


CA3 MAX Baud Rate. xxxx 

CB3 MIN Baud Rate. xxxx 

CC3 Starting Baud Rate... xxxx 


CA3 Max Baud Rate - Toggles the maximum baud rate. Baud will 

toggle up to the next baud rate each time the key is pressed. 
Set the maximum baud rate your modem supports. C3/12/24/96) 

CB3 Min Baud Rate - Toggles the minimum baud rate. Baud will 

toggle up to the next baud rate each time the key i3 pressed. 
Set the minimum baud rate you wish to support. C3/12/24/96) 

CC3 Starting Baud Rate - Toggles the starting baud rate. Baud 
will toggle up to the next baud rate each time the key is 
pressed. Set to the baud rate you want the phone answered. 

You can not specify a starting baud rate less than minimum 
or greater than maximum. Starting Baud rate will automatically 
be set to maximum baud rate if maximum is 2400 or greater. 

This is usually a modem requirement that the port speed be 
set to the highest baud speed for the modem to answer the 
phone, so we set this for you if maximum is above 1200. You 
can not override this feature. 
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t&3 lilac. P.rn»»t«r»l CA3 Caller Type. xxxxxxxxxxxxx 

CB3 Display Columns., xx 

CC3 Change Foreground Color 

CD3 Change Background To Next Color 

CE3 Change Background To Next Hue 

CF3 Change Border To Next Color 
CG3 Change Border To Next Hue 
CH3 Set Border To Background Color 
C13 Reset To Default Color Set 


CA3 Caller Type - Toggles between Atascii Only and Ascii/Atascii. 
This allows you to set the caller type the board will accept 
at logon. 


CB3 Display Columns - Toggles between 40 and BO columns. 

CTech Nate: Future enhancement. Uersion 1.0 currently does not 
use this field.) 


CC3 Change Foreground Color 
CD) Change Background To Next Color 
CE3 Change Background To Next Hue 
CF3 Change Border To Next Color 
CG3 Change Border To Next Hue 
CH3 Set border To Background Color 
CI3 Reset To Default Color Bet 


Options ’C’ thru ‘I* function 
as indicated. Press the 
appropriate option letter to 
perform the desired function. 
The color combination that you 
set on your screen 
will be the colors displayed 
while the board is running. 


C73 ExoressNET Parameters! C A3 Node Number. xxxxx 

CB3 Node Name: 

xxxxxxxxxxxxxxxxxxxxxxxxx 
CC3 Node City/state: 

xxxxxxxxxxxxxxxxxxxxxxxxx 
CD3 Network Drive. Dx: 

CA3 Node Number - Your BBS node number if you are using the 

ExpressNET interface feature. Your node number is the 3erial 
number found on your master BBS Expressl PRO diskette. This 
is the number by which other ExpressNET systems will know 
you. 

CB3 Node Name - Your BBS name as you want it to appear in network 
messages sent to other ExpressNET systems. 

CC3 Node City/State - Your BBS City and State as you want it to 
appear in network messages sent to other ExpressNET systems. 

CD3 Network Drive - Specifies the drive number where the NETWORK 
directory may be found. Pressing this letter will increment 
the drive number. 


ft 
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t83 Event Schedul an 


Event 

Schedule Days 


Event 

Type 

S- 

-M- 

-T- 

-W- 

-r 

-F- 

-s 

Hr 

Name 

Every 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

0 

uihomaint 

Timed 

N 

N 

N 

N 

N 

N 

Y 

22 

ULPURGE 

Timed 

N 

N 

N 

N 

N 

N 

Y 

23 

ULBACKUP 

OFF 

N 

N 

N 

N 

N 

N 

N 

0 


OFF 

N 

N 

N 

N 

N 

N 

N 

0 


OFF 

N 

N 

N 

N 

N 

N 

N 

0 


OFF 

N 

N 

N 

N 

N 

N 

N 

0 


OFF 

N 

N 

N 

N 

N 

N 

N 

0 


OFF 

N 

N 

N 

N 

N 

N 

N 

0 


screen 

allows you 

to set up events 

sr every 

call or 

on 

a timed basis. Up 

run. The 

arrow 

keys 

allow you to move 


TJis Event Scheduler screen allows you to set up events to run 
automatically either after everu call or on a timed basi3. Up to 30 
events can be set up 
entry you wish to edit. This screen, like previous screens, will move to 
the next page when the down arrow key is pressed and you are on the last 
entry on that page. The up arrow key will move you to the previous page 
when you are on the top entry. Once, you are positioned to the entry you 
wish to edit, pressing the return key will place you in edit mode. The 
line will clear and a prompt will be displayed for the appropriate entry. 
If option 2 is selected, the cursor will move to the event name. The 0 
character name of the avBnt should then be entered (Refer to the Event 
Scheduler section for a list of the supplied events on the master disk}. 
If the filename is less than B characters, press return, otherwise entry 
terminates on the 0th character entered. The hi-light bar will re-appear 
to indicate the entry has been saved in memory. If you select the event 
as a timed event, you will be prompted for the days and the hour that 
this event should be run. Hitting a return during days entry will 
default to a Y entry. The hour should be entered in military time CO-233. 
If you wish to reset an event to OFF, position to the event entry and 
hit the return key twice. 


Creating The UserLog 

Create the userlog by running the program MAKEULOG.COM. You will 
first be prompted to enter the number of users you want to allow in the 
userlog. This can be any number up to S5535. To aid you in this 
decision,1 user record requires 1 double density sector C256 Bytes). 

In addition, the system will reserve the first 9 records for it's 
own use, so the sysop is actually user number 10 and the co-sysop is 
user number 11. If you do not plan to have a co-sysop, the system still 
reserves user number 11. The board treats these 2 user id's differently 
from the rest, As an example of this, user record 10 and 11 are not 
recorded in the "who's called log” for users to see. This way, you and a 
co-sysop can pop into the board without alerting users that you were 
there. 

Next, you will be asked to enter the drive number on which to 
create the userlog. This can be any drive 1-0. 

The program will now start creating the userlog assuming that the 
subdirectory PRO>USERLOG> exists on the drive that you specified. If not, 
the program will exit back to the DOS prompt allowing you to create the 
subdirectory or rerun the program selecting a different drive number. 
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Creating The Meemag# Baeee 


Create the message bases by running the program MhKEMSGB.COM. You 
will First be prompted to enter the message base number that you want to 
create. Hitting return will create the default message base that i3 
displayed on the screen C thl3 aluiay3 starts at message basB #1 ). 

Next, you will be asked For the number of messages that you want in 
this base. This can be up to 550 messages. 

Then, you will be asked For the drive number on which to create 
this base, Any drive 1-8 may be used. 

Next, you will be a3ked to name the message base. Up to 50 
characters may be keyed and may be upper,lower or atascii characters. 

Then, you will be asked if you want to allow ATASCII graphics on 
thl3 base. Enter a ’Y' or 'N'. 


Finally, you will be asked for a size ( S-9 ) of the message base. 
The chart below will aid you in selecting the appropriate size for your 
need3. 


Size Selected 

# 

Of Messages 

# Bytes Per 

Message 


Total Base Size 

5 


100 

365 



79,360 


3 


100 

618 



104,960 


4 


100 

874 



130,560 


5 


100 

1130 



156,160 


6 


100 

1386 



181,760 


7 


100 

1645 



507,360 


0 


100 

1898 



535,960 


3 


100 

5154 



558,560 


The number i 

of 

bytes par massage in the 

chart above represents 

the 

number of bytes 

available when 

posting a massage. 

I r 

your dase 

size 

selected was ’S' 

, 

tha user would be able to 

key up 

to 

1130 bytes 

into 

the message. 









Assuming a message base of 550 messages and size 8, the maximum 
size of a message base would be 645,560 bytes. 

The program will now start creating the message base assuming the 
subdirectory PR0>BASES> exists on the drive you specified. IF not, the 
program will exit back to the DOS prompt, allowing you to create the 
subdirectory or rerun the program, selecting a different drive number. 
Once the message base has bBen created, the base counter increments and 
the process continues for the next message base. 

Regardless of how many message bases you decide to have online, 
remember that you must always create message base 35. This serves as the 
Email base. Once message base 35 is created, the MAKEMSGB program will 
exit back to the Dos command prompt. 
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Creating The File Bigs 

BBS Expressl PRO supports up to 32 download fils sig areas and 1 
upload fils sig. All uploads go to this one fils sig area. They ars not 
visible to the user until validated by the sysop. C Refer to the Neui 
Files Ualidation section for the procedure on validating new uploads!. 

Each download file sig is actually a subdirectory named FILES—XX 
XX is the sig number Cl thru 32). Within the FILES-XX subdirectory up to 
127 subdirectories can exist named F001 through F127, These sub¬ 
directories must be created in sequential numeric order. The actual 
download Files are stored in these subdirectories. Under each of the 
F001 thru F127 subdirectories are subdirectories called VESC . Thi3 is 
where the description to the file is stored. A quick calculation shows 
127 subdirectories, each containing up to 127 files, yields space for 
16,123 download files per File sig area. With 32 file sig areas, 516,120 
files online at one time is possible. 

Let's look at one download file sig area pictorially to illustrate 

this: 


I PRO ! 

+ - + 

I 

+-+ 

I FILES-011 

+--4 

I 


I I I I I I I 

4*- + +--♦ + --+ +--+ + ---+ +-♦ ♦-+ 

IF001IIF002IIF003IIF004IIF005IIF006I..thru.. . IF127I 

+-4*4--4-4--4-4--4-4--4 +-+ -+ 

I I I I I I I 

4--— — 4.4--4 4--44————44-4-4---4- +- + 

!DESCI IDE5CI IDESC!IDESCI IDESC!!DESCI IDESC! 

4.-4.4.-4.4.-4-4--4-4--4-4--4- 4--4- 

Each of the 32 file sig areas is structured exactly like this 
example, except the FILES-01 subdirectory would be named FILES-02, 
FILES-03 etc. 

Now this may seem like a lot of subdirectories Cand it is), but the 
thing to remember is only the FILES-XX. F001 and the DESC under F001 need 
to be created initially. The additional F002, F003, etc and DESC undBr 
each of them can be created later as you need thBm. IF this still seems 
a little confusing, you might want to read the section on new Files 
validation For an explanation of how the board will move the new uploads 
into these File sigs. Once the subdirectories have been properly created, 
it’s not something you have to worry about or remember to get the new 
Files into these areas. 
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f) word of caution _ when creating the F001, F002, F003 

subdirectoriea, don't skip a nu mber. The board uill be tricked into 
thinking there are no more subdirectories in the sig area if it 
encounters a non-existent numeric subdirectory. You can have FILES-01, 
FILES-10, FILES-20 with gaps in-between but not within those 
subdirectories. When creating the additional subdirectories, don't 
Forget to create the DESC subdirectory under it so the File descriptions 
can be saved. The user can still upload File3 iF you Forget, but would 
see an Unable to Create Description File ' message when the BBS tries to 
save the File description. 


Creating The Help Menue 

The necessary help menu3 this board requires are on the master 
diskette in the HELP40 and HELP80 subdirectories. Oil oF these Files 
are text Files, and can be edited with any text editor. 

PRO has 4 sets of menus available For display. They are based on 
the caller's video width and translation. The help menus are broken down 
into 2 subdirectories called HELP40 and HELP80. Within each oF these 
subdirectories are H sets oF menus distinguished by the extenders -ATA 
For ATASCII menus and .ASC For ASCII menus. When the user calls For a 
help File to be displayed, PRO will display the appropriate help File 
based on the user's current settings. This makes It easy to customize 
tha help Files For both 40 and 00 column users as well as ATASCII and 
ASCII users. The help Files provided on the disks are generic in nature, 
but can be used to get you started. They are intended to be a starting 
point and can be customized to your liking. 

The next page contains a table oF variable tags available For use 
in menus. To aid in the conversion of existing menus, we have included 
the 1030/050 variable tag equivalent For those oF you running tha 
current version oF BBS Express I 
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PRO Variable Tags Definitions Table 
Tag Name Number 1030/050 Version Equivalent 

Clear The Screen 800 


Users Handle 801 

Users Real Name 802 

Users Password 803 

Users Address 804 

Users City/State 805 

Users Zip Code BOB 

Users Country 807 

Users Phone Number 800 

Users Age 803 

Users CPU Type 810 

Users Lastcall Date 811 

Users Time Limit Per Call 812 

Users Time Limit Per Day 813 

Users Minutes On Today 814 

Users Last Read Message 815 

Users DL Ratio 816 

Users Downloads 817 

Users Uploads 810 

Users Messages Posted 813 

Users Emails Sent 820 

Users Total Calls 821 

Users Video Width 822 

System Hi Message 823 

System Total Calls 824 

System Calls Today 825 

System Last Caller 826 

Current Translation 827 

Current Date 820 

Current Time 829 

User Number Online 830 

Current Baud Rate 831 

Free Time This Call 832 

Minutes Connected 833 


802 

803 804 

805 


806 

80S 

80S 

810 

812 

811 


814 

822 

824 

835 

820 


813 

821 


836 


825 


Note i Tags numbers 07,13,15,16,17 
10,23,26,27,20,23,30,31,32 
33,34 have no direct 
translation to PRO. 
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These variable tags can be u3ed in your help Files in place of hard 
coded literals. Let’s look at an example of a typical welcome help File 
and 3BB houi these variable tags are used. 


This is uihat your help File would look like: 


800 


Hi 801.. . 

Welcome Aboard The Midnight Express! 
Houi Are Things In SOS? 

Your Last Call Was On 811... 

You Just Missed 826... 


And this is houi the user would see it at logon: 
The user’s screen would clear due to the 800 


Hi John Doe... 

Welcome Aboard The Midnight Express! 
How Are Things In Midlothian,Ua.? 
Your Last Call Was On Fri IB-Apt SB. 
You Just Missed Keith Ledbetter... 


All the variable tags were replaced with meaningful information 
based on their current values. You can use these variable tags in help 
Files, menus or text Files anytime uou want this variable information 
displayed to the user. An t> with no digit C’O' - ’3’) next to it will 
display as a normal ’8’. In other words, saying This » that in a menu 
File will display ’This 4 That', Just as it should. 


The master disk contains a complete working set of help Fil” 
and BO column Format For both ATASCII and ASCII translation. These should 
be copied to your PR0>HELP40> and PR0>HELP80> subdirectories and can be 
used as is. 
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Modifying Your Startup.Bat File 

Your Startup.Bat fila should include the following SpartaDOS 
commands in addition to any other commands that you run during your 
startup.bat procedure. 

TDLINE.COM 

RSH3S.COM (not naadad if using an 010) 

BBSPREP.COM (Must ba tha LOST fila toadad that altars Lodam) 

IF your ramdisk is of sufficient size, we suggest that you create 
the subdirectory PR0>C0MMANDS> C even if you are running with a hard 
drive ) and copy all the command modules to the subdirectory on the 
ramdisk. This can be performed within the Startup.Bat if you wish. 

Considering that the command modules are loaded quite a bit during 
board operation, placing them in the ramdisk for access will speed up 
the response time to the caller and reduce the wear and tear on your 
hard drive by only having to read the commands once From the hard drive 
each time the system is booted. 

Autoboating the BBS from the Startup.Bat File, and thereby making 
the board self booting can be achieved by making the BBS.COM file the 
la3t command in the batch File. Also keep in mind that running a batch 
fila From a batch File terminates the original batch file even though 
you may have had more commands to execute. You can use this to your 
advantage by making the board setup batch file a stand alone batch file 
in your PR0> subdirectory. Adding one line to the end oF your 
Startup.Bat file to run the batch file to configure and run the BBS. 
Should you need to hit reset to go back to DOS to perform something, you 
can restart the board by typing BBS. The BBSPREP.COM file takas care of 
reinitializing the device handler table that the reset destroys and 
resetting LOMEM. By doing this, once you have loaded the necessary 
drivers Cie Startup.Bat), you may start and reset tha board as many 
times as you like without having to turn the computer off and reboot 
the system. 
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Con-figuring The Modem 


The exact dip switch settings will vary from modem to modem 
depending on the manufacturer of your modem. As a guideline in setting 
up your particular modem to run with PRO, the fallowing criteria should 
be used in determining the correct DIP settings. 

1. The modem should only turn on the carrier detect pin when a 

remote carrier i3 present. 

2. The modem should hang up and return to command mode when the DTR 

goBS off. 

3. The modem should return messages back to the CPU in words. 

4. The modem 3hould understand it3 own commands. 

5. The modBm should be in Asynchronous mode. 

6. The modem should NOT be in auto-answer mode. 

Here are some example Dip Switch settings for a few of the popular 
modems being used today. 

Hayes and SmarTeam 300/1200 Baud Modems 


Switch 

1 - UP 

Switch 

2 

- UP 

Switch 

3 - DOWN 

Switch 

4 

- UP 

Switch 

5 - DOWN 

Switch 

S 

- UP 

Switch 

7 - UP 

Switch 

8 

- DOWN 


Avatex 300/1200 (Non HC version) 
All Dip Switches should be UP 

Avatex 300/1200 (HC version) 


Switch 

1 

- UP 

Switch 

2 

- UP 

Switch 

3 

- DOWN 

Switch 

4 

- UP 

Switch 

5 

- DOWN 

Switch 

E 

- UP 

Switch 

7 

- DOWN 

Switch 

8 

- DOWN 


Most of the 2400 baud modems on the market today use internal or 
'soft set’ dip switches. They require that you configure them using a 
communications program In terminal mode. Ulith your modem turned on, boat 
your terminal program and enter terminal mode. Make sure you are set to 
ASCII translation, Half Duplex and set to the 2400 baud. Key the 
following commands terminated by a return. The modem should respond with 
the message ’OK’. 

ATSiF - resets the modem to factory settings 

AT&Cl - turn the carrier detect pin on only when a remote carrier 
is present 

ATtD3 - modem will hang up and return to command mode when the 
DTR pin goes off 

ATS0"0 - turn off auto-answer mode 

AT!<W - writes the current settings to non-volatile modem memory. 
The modem may be turned off or even unplugged and the 
settings will not be destroyed. 

Once thBse settings are made, you should never have to reset them. 
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* * * * A special not# concerning tha Atari 3X212 modal* t t t t 


While PRO mill run on the SX212 if you use an interface through the 
modem RS232 port and load the appropiate handler, the BBS will not run 
through the SIO port. There are no plans convert BBS Express! PRO to 
run through this modem port. 


* • * * A special note to Avatax 1200 owners * * * * 

The Avatex 1200 Cnon-HC) is a non-standard, get very popular modem. 
Unfortunately, it does not understand mo3t "Hayes Compatible" commands. 
There is a special "WaitCall” module on your PRO disk that was written 
specifically for the Avatex 1200 modem. This file is named WTCALLAU.CflO. 
If you plan on running PRO on this modem, you should copy this command 
module to your PR0> C0IH1AND> subdirectory under the name WAITCALL.CMD. 
This special module takes the place of the standard waitcail module. 
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User Editor And Syatam Security 


With BBS Express! PRO, you have COMPLETE control over almost every 
thing that a user can or can’t perform. By now you may have noticed that 
everything under BBS Express! PRO is broken up into 32 ’ a . There 
are possible maximums of 32 message bases, 32 file SIG areas and 32 
command levels. 

Additionally, each user’s record has groups of 32 on/off flags for 
different functions. These possible functions are broken up in the 
following manner. 


For the message bases, there are 32 individual flags for: 

o Can the user READ messages on thi3 base? 

o Can the user POST messages on this base? 

a Can the usBr EDIT "ANY* message on this base? Cco-sysop function) 

o Can the user DELETE *ANY* message on this base? (co-sysop function) 

o Can the user PRINT »ANY* message on this base? Cco-sysop Function) 

For the file area, there are 32 individual Flags far: 

a Can the user ACCESS this SIG? 

o Can the user EDIT DESCRIPTIONS on this SIG? Cco-sysop function) 

o Can the user DELETE "ANY* file on this SIG? Cco-sysop function) 

For the command security, there are also 32 individual Flags to 
signify whether a user may execute that level of a command. 


As an example, let's assume that tus have a user named John Doe that 
has the following security level flags: j 

COMMANDl 1111111111222H2H2222333 

12345S7BSO12345678SO12345S703O12 

Commands Y Y . 

MSG BASES 11111111112222222222333 

1234567B901234567B901234567B9012 

Read? YYYY..Y.Y . * 

Post? YY....Y .Y. Y 

Edit? Y Y . 

Delete? YY.Y. 

Print? YY.Y. 

FILE SIG3 1 1 1 1 i 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3 3 

1234S67B901234567B901234S67B9012 


Access? YYYY .Y 

Edt Desc?.Y 

Delete? . 
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Now... What exactly can John do? Well, as Far as command levels, 
he can execute level 1 and 2 commands. Remember, command levels for each 
Individual command are kept in your SYSDATA.DAT File, and can bB changed 
by using the SYSEDIT program. This is probably the right time to explain 
the importance oF NOT giving people 'Sysop Accrss' .First, always keep 
the security level of the 'Sysop Command Mode’ (in your SYSDATA File) at 
level 32. Next, NEVER give any of your users level 32 command access 
unless you are perfectly sure of what you are doing. Why? Well, the 
reasons are simple. A terribly upset level 32 Sysop could wipe out your 
ENTIRE hard drive in a matter of minutes. The 'Dos Shell' of BBS 
Express! PRO is about as powerful as SpartaDOS itself. From within the 
Dos Shell, it is possible to delete every user in your userlog, delete 
any file on any of your drives, delete any subdirectory, etc. 

As for the massage bases on our BBS, John can da the following. He 
can can READ messages on bases 1, 2, 3, 4, 7, S, 15 and E-mail (#32) Cif 
a user can not read messages on a base, they will be greeted with an 
'Invalid Security' if they try to enter that base!. John can POST 
(write) messages on message bases 1, 2, 7, IS and E-mail. Thus, it’s 
possible Cand sometimes very convenient) to allow a user to read 
messages on a massage base without allowing them to write messages or 
reply to existing messages. This is sometimes the perfect set-up for 
'NEW' users. 

Not long ago, John came to us with a request. You see, John is an 
ST user, and he asked us if we would add a new message base and File SIG 
area devoted to ST users. Our reply? Well, as any good Sysop would do, 
we said 'Sure, John...as long as YOU volunteer to maintain it! You will 
have to police the message bases for any vulgar messages and edit any 
file descriptions that you think can be improved’. 

Well, John agreed to be Co-Sysop of the ST areas. So, we set up a 
new message base and new file SIB, both as #15. We then updated John’s 
security levels (which are shown above). If you look at John's message 
base flags under base 15, you will sea that he can do just about 
everything that is possible on a message base. He can read, post , 
delete, and print messages (in case he wants you to see one). But he 
can’t edit messages. While we like John, we don’t want him editing other 
people’s messages and possibly changing something that is said (this is 
probably unrealistic, but used mostly for demonstration purposes). 

In the file SIG’s. John can only access file areas 1, 2, 3, 4 and 
15. Once again, he has much more Freedom in the #15 file area. There, he 
can also edit any File description. He does not have the ability to 
delete any file on that SIG, as we would prefer to do that on our own. 

Now that you understand how the security levels control each user’s 
actions, we can discuss two VERY important ’user records’ in your 
userlog file. These records are referred to as the NEW USER RECORD and 
the VISITOR RECORD. These records are Just like any other userlog data 
record, except that they are solely for your use, and no user can ever 
log on with them. 
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Their Importance ie that they control uihat happens when a NEW user 
log 3 onto your board Ceither as a permanent user or a visitor). Here is 
uihat BBS Express! PRO does: when a user logs onto your board as NEW, 
Express! will ask them if they want a permanent password. If they 
respond with ’Yes’, the NEW USER RECORD contents will be copied into 
their user record. If they respond ’No', then the UISITQR RECORD 
contents will be copied into their user record area. So, these records 
become the base that their records are built upon. 

Not every field In the NEW USER and UISITOR records are Important. 
For example, any data that the user is prompted for (such as handle, 
name, address, etc) will overwrite what was in the new u3er/visitor 
record. The most important fields in the new/visitor records are the 
security levels and the time limits. Here is a list of the fields that 
you SHOULD update in your new user and visitor records: 

Time limit per call 
Time limit per day 
Download ratio 


Command Security Level 
Message Base Security Level 
File SIG Security Level 

Now let's look at the various functions in the user editor. The user 
editor can be accessed from either the main menu (If you have it defined 
in your main command table) or from the Dos Shell by typing UEDITOR from 
the Dos Shell’s command prompt or from the "Waiting For Call" screen. 

This is what you see when the UEDITOR first loads: 


Edit Which User? 


CUT by User number 
CH3 by Handle 
CR3 by Real name 

CU3 Uisitor rec 
CN3 New User rec 


C03 Online user 
CF3 First new 
CA3 Odd new user 

C1-73 Edit mask 
CX3 Exit 


Your choice: 


If you edit a user by one of the above options, that user record is 
read into memory and the following menu is displayed to you: 

Editing: SYSOP (#10) 

Status: Active/Ualidated/LOCKEO 



Edit 

What? 


CT3 

Textual data 

CL3 

Lock user 

CU3 

Usage data 

CD3 

Delete user 

CC3 

Command sec. 

C 1-73 

Apply mask 

CM3 

Message sec. 

CX3 

Exit 

CF3 

File sec. 




Your choice: 
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If you select option T to edit textual data you mill be presented 
with the following: 

Editing: SYSOP 0*10) 

Status: Active/Ualidated/LOCKED 


CA3 Handle: 
CB3 Real Name: 
CC3 Address: 
CD! City: 
CE3 Zip Code: 
CF] Country: 
CG3 Phone: 
CH] Computer: 
C13 Age: 
CJ3 Password: 


SYSOP 

Keith Ledbetter 
1334 Any Street 
Midlothian, VA 
23113 
USA 

373-4156 
Atari Call) 

30 

atari 


A-J, OK, or LIST: 


If you select option U to edit usage data you will be presented 
with the following: 

Editing: SYSOP 0*10) 

Status: Active/Ualidated/LOCKED 


CA3 Tima/call : 
CB3 Time/day 
CC3 Mins today: 
CD3 Downloads : 
CE3 Uploads 
CF3 DL ratio : 
C63 Last read : 
CH3 Msg posted: 
CI3 Email sent: 
CJ3 ** of calls: 
CK3 Last call : 


255 

255 

1 

0 

0 

255:1 

1 

0 

0 

1 

Mon 18-Apr-BB 


A-K, OK, or LIST: 


If you select option C to edit command levels you will be presented 
with the following: 

Editing: SYSOP 0*10) 

Status: Active/Ualidated/LOCKED 

Which command levels can this 
user execute? 

CY, N, or Return) 

112 2 3 

- 5 -o-5-0-S-0— 

Now: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 
New: 
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If you select option M to edit message base security data you will 
be presented with the following: 

Editing: SYSOP C#10) 

Status: Actiue/Ualidated/LOCKEO 

What message base actions can 
this user perform? 

112 2 3 

-5-0-5-0-S-0— 

A] Rd yyyyyyyyyyyyyyyyyyyuuuyuuuuyuyyy 
b: uir yyyyyyyyyyyyyyyyyyyuuuuyuyywyuuu 
Cl Ed yyyyyyyyyyyyyyyyuuuyyuuuyuuuuuuu 
01 0e yyyyyyyyyyyuuuuuyuuuuuuuuuuuuuuu 
El Pr yyyyyyyyyyyyyyyyyyyyyuyuuwuuuuyu 

A-E, OK, or LIST: 


r 


If you select option F to edit file SIG security data you will be 
presented with the following: 

Editing: SYSOP (#10) 

Status: Active/Ualidated/LOCKEO 

Uhat file SIG actions can 
this user perform? 

112 2 3 

-g-o-S-0-5-0-- 

ai Rd yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 
bi Ed yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 
ci Oe yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 

A-C, OK, or LIST: 


s 


! 
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Message Bases 


The message bases are accB33ibla through aithar the = command to 
go to any individual message base or through thB □ command to perform a 
Quickscan of any new messages on all the bases since the user’s last 
call . 


The command prompt in the message base processor contains 4 pieces 
of information. Here are a few sample message base prompts. 

C1N50+) General: 

C50\50+) General: 

CQ\1\50) General: 

The first parameter specifies either the read direction that you 
are currently in C forward or backward) or ’0’ to signify that 

you are in QuickScan mode. The next parameter specifies the current 
message number within the message base that you are on. This is the 

message number that any of the base commands will act upon. The <Return) 

key always takes you to the next message number.The next parameter 

specifies the number of messages currently active in this message 

base.The last parameter specifies the name of the message base you are 
currently in. 

Access to a message base is determined by the user's message base 
security flags. If the READ flag is set for a base, they can read 
messages on that base. If the POST flag is set, they can also post 
messages on that base. A user can always edit or delete a message that 
they have pasted, but would require the appropriate security flag be 
turned on to perform those functions on a message written by someone 
else. 


Printing a message to the local printer requires that the PRINT 
security flag for that message base be set ON. This option is available 
for use by using the H key in the message base processor. This function 
does not appear on the menu. 

Should the need arise from time to time, the sysop may change the 
name of the message base by using the Z key. You will then be prompted 
for a new message base name. This option is only functional if the 
command level 32 security flag is turned on. 
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Download FI la Slga 


Each of the possible 35 download File sig areas is accessible to 
the user if their File sig security bit has been turned on by the sysop. 
IF a user can get into the File area, then they will be able to see ALL 
files in that area. The security is at the FILE AREA level. You either 
can or can't get to the area. If you can, you can see everything. 

Listed below are the 7 functions that can be performed while at 
the File area command prompt. 

CB3 Browse files with descriptions 
CC3 Catalog files, 15 per page 
CN3 New Files since your last call 
CU3 Upload a new file 
C/3 Go to the next file area 
C“3 Go to another file area 
CX3 Exit to the main menu 

Option CB3 Browse files with descriptions 
If the user selects option B, they will be presented with one file at 
a time for viewing. Like this: 

FILENAME COM 5500 1-31-07 5:09p 


this is the description for filename.com 

COlownload CR3ead CE3dit Desc 

CAlgain CClontinue CT3rashcan 

COluit 


The user may select any of these options, except E and T. These two 
options will only function if the user’s security bit for editing 
descriptions and deleting files For this File sig has been turned on. 

If the user selects the download option, they will be prompted 

with: 

Sltandard C3RC Xmodem or YJmodem? 

Once the user makes a download protocal selection, the File 
transfer begins. 


Option EC3 Catalog flies, IS per page 
If the user selects option C, they will 
files at a t: 


be presented with up to 15 


for viewing. Like this 
Filename 

Size 

Date 

CA3 FILE1 

COM 

5500 

1-31-87 

CB3 FILES 

COM 

5300 

1-31-07 

CC3 FILE3 

COM 

5400 

1-31-87 

CD3 FILE4 

COM 

5500 

1-31-07 

CD3ownload CR3ead 

CQ3uit 

CC3ont: 


IF the user selects the download option, they will be prompted 

with: 

Download which File CA-D57 

The user makes their File selection for downloading by letter and 
will be prompted again with: 

Sitandard CIRC Xmodem or Ylmodem? 

Once the user makes a download protocal selection, the file 
transfer begins. 
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New Files Validation 


When a U30r uploads a File to your system, it i3 always sent to the 
PRO>UPLOAD> subdirectory. The file remains there, inaccessible to the 
user, until you validate these Files. 

To validate neui uploads, go into the Dos Shell and execute the 
command module NEWFILES. NEWF1LES will scan the upload directory and 
present you with each uploaded File one at a time like this: 

FILENAME COM 5200 1-31-07 2:0Sp 

this is the description For Fllename.com 

CUlalidate CRlead File CEldit Desc 
CDlelete CN3ext File CClhange Name 
CODuit 

CFunctlon3“> 

Validate Option - will allow you to validate a File. You will then 
be prompted with: Move to which File area CO-List)? 

You may enter a 0 to see a list oF your download File areas or 
speciFy a File area to move the uploaded File. The NEWFILES module will 
scan the File area you speciFied, looking For an available subdirectory 
to move the File. It will start looking in the F001 subdirectory. IF 
there aren’t 127 Files in that subdirectory, the File will be moved 
there,IF Full, NEWFILES will continue looking thru F002, F003 etc. until 
it Finds a subdirectory with room to move the File. Once an available 
subdirectory is located, the File and it’s description is copied into 
the subdirectory. The original File and description is deleted From the 
upload subdirectory. The next upload File is displayed and the process 
repeats itselF until all the Files in the upload directory have been 
presented. Once all uploads have been displayed, you are returned to the 
Dos Shell command prompt. 

Read File Option - will display the File to the screen (and modem iF 
logged on remotely) and then redisplay the File entry. 

Edit Desc Option - will allow you to edit the current File description 
or create a new one iF none exists. 

Delete Option - will allow you to delete the File without validating 
it. Both the Filename and File description will be deleted. 

Next File Option - will allow you to continue to the next upload File 
without disturbing the current File presented. 

Change Name Option - will allow you to rename the File beFore 
validating it. Both the Filename and File description are renamed. 

Quit Option - will allow you to abort new Files validation prior to 
viewing all new uploads. 
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The Doe Shell 


The Dos Shall i 3 an environment uihara board maintenance and mo3t 
of the major SpartaOos Functione are performed. The board comes 
configured to you with this function accessible from the command Prompt 
by simply pressing the S. From the -Waiting For Call screen 
option 0. There are currently over 35 commands available in the Dos 
Shell. 0 help menu is available while in the Dos Shell. Press . 
commands became available, it's a simple matter to copy the command into 
the PRO>COMHAND> subdirectory. The command is automatically available to 
you From the Dos Shell. You can add commands C.DID files) to the command 
subdirectory up to the subdirectory limit of 127. The best way to get a 
feel For what the Dos Shell can do is to use it once you have the board 
running. 

The commands function as they would From SpartaDos, with a few new 
ones, like COUNT and SHUTDOWN. COUNT simply counts the files and 
subdirectories in the current path and displays the statistics back to 
you. CHandy for knowing if a subdirectory is getting close to fUlioa 
up.) SHUTDOWN, if executed, will effectively lock the BBS program an 
will keep it From responding to incoming calls. It does not turn the 
power off or return the system to the DOS prompt b ^. r ® ther ^i 
the BBS From processing incoming calls until a key is hit From the loc 
keyboard. Once you have shutdown the system remotely, you can 
re-enable it remotely. That can only be done from the local keyboard. 

ft safety feature of the Dos Shell is if you enter it locally while 
a user is online and allow the user to see what you are doing, they will 
not be able to execute any commands because the Shell will not accep 
return from the modem. They would be able to key in commands but when 
they hit return, the Shell would tell them that commands can only be 
executed locally. It allows them to key in a command while you lQC “lly 
execute a return for them. You can temporarily set them up with command 
level 32 to allow them to perform Functions in the Shell. Don t F °r0 
to turn their command level 32 off after the call or they could enter 
the Shell on their next call and perform functions unattended. This 
feature was designed to stop a user from attempting to send a DELETE 
macro across the modem before you could react to it. This only occurs 
if the Dos Shell was invoked locally. If you or a co-sysop call 
invoke the Dos Shell remotely, all functions are enabled remotely as if 
you were at the local keyboard. 

The Dos Shell’s "command line parser” is extremely intelligent. For 
example, here are various ways you could enter the same command: 


COPY D1:> PRO> COMMANDS)•.* 02:>PR0>C0MnANDS>*.* 
COPY D1:>PR0>C0M*>».« D2:>PR0>C0HMflN0S> 

COPY D1: > PR0>C0nnnNDS> D2:>PR0>C0t1»> 
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BBS Express! Pro-fassional 
Dos Shsl1 Menu 
Orion Micro Systems C13B8) 

C 3 Denotes Optional Parameter 

Directory Commands 

Dx: - Change Drive 

Dir CDx:3 - Long Dir. 

Dirs CDx:3 - Short Dir. 

PDir CDx:3 - Print Long Dir 

PDirs CDx:3 - Print Short Dir 

Credir Path - Create Dir. 

Deldir Path - Delete Dir. 

CUD Path - Change Dir. 

Count CPath3 - Count Files 

File Commando 

Erase Dx:Fn - Delete File 
Delete Dx:Fn - Delete File 
Rename Dx:Fn - Rename File 
Type Dx: Fn - Uiew File 
Uiew Dx: Fn - Uieui File 
Copy Src Dest - Copy Fiie 
Copy/N Src Dest - Copy File 

Cauto overwrite existing File) 
Print Dx:Fn - Print File 

Lock Ox:Fn - Lock File 

UnLock Dx: Fn - Unlock File 

Disk Commands 

ChkDsk CDx:3 - Disk Statistics 

Protect Dx: - Protect Disk 

Unprotect Dx: - Unprotect Disk 

Malnt. Commands 
Ueditor - User Editor 

EditFile CDx:Fn3- File Editor 

NewFlles - Ualidate Uploads 

Uieuievnt - Uiew Event Status 

ULPrint - Print ULog Utility 

ULBackup - Backup User log 

Time Commands 

Settime - Set Time 

Setdate - Set Date 

Showtime - Display Time 

Showdate - Display Date 

Misc.Commands 

Chat C0n/0FF3 - Turn Chat On/OFF 
Or Display 
Current Setting 

ShutDown - Deactivate BBS 

Help or ? - Help Menu 

Exit or X - Exit Sysop Mode 

MOTEi From the DOS shBll, any external command may be ran by 3 implu 
keying in it3 name Cie: FILEST8T or UEDITOR). 
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ExpressNet Networking 


ThB ExpressNET networking feature of PRO is an automatic massage 
networking Facility For exchanging messages with another BBS Express! 
PRO system. This can be a second board you run, or a PRO board across 
town or across the country. 

Operationally (From the sysop’s point of view) it is a very simple 
process. 

Here is a pictorial of a sample network setup. 


+—>-I Board 1 

I +- 


I->-+ 

+ I 


! Board 4 


Board 2 I 



-1 Board 3 !■ 


As you can see, this sample network contains 4 boards. The arrows 
show the direction the messages would flow. The key thing to remember 
when networking is 'tha board initiating tha call racaivas 
aassagas'. In order to achieve this Flow, board H would call board 1 to 
receive new messages. Board 3 calls board 2. Board 4 calls board 3. And 
to complete the loop, board 1 calls board 4. 

In a 2 board network, board 1 would call board 2 to receive 
messages and th B n board 2 would call board 1 to receive messages. This 
was done this way, so that 1 board would not have to bear all the cost 
of long distance charges. After all, why should you pay ths LD cost3 For 
someone else to get messages to post on their board. You make the call, 
you get the messages, simple as thatl 

Networking with another PRO board is not something that Just 
happans '. You and the sysop you will be networking with must both agree 
on the bases you want transferred and set up each side accordingly. You 
must set up a user id for the other sysop’s use when calling your board 
as a network caller, and he must set one up For you to use when you call 
hi 3 board thru ExpressNET. Once you have this information, you are ready 
to set up the parameters necessary to network with the other board. 
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Thera are 8 parts to the ExpressNET subsystem. They are 


ECHONET.DAT 


contains the node list of boards to build 
outgoing massage packets. This File can be 
editted with any word processor. It contains 
one line for each board entry and looks like 
this: 

1 25 PRO Support Board 


I I I 

I I Comments (Optional 5 

I I 

I The nodes user number 

The node number of board for which 
you are building the message packet 


Each of these fields are separated by 1 
space. 

NETEDIT.DAT - contains the network node list of boards that 
you are calling to receive message packets. 

INCOMINS.DAT - this is the data file which contains the 

incoming message packet containing messages 
that will be posted on your board by NETUPDT. 
When NETUPDT posts the messages to your bases, 
it automatically deletes this dataset. 


NETEDIT.CMD 

NETPREP.CMD 

NETCALL.CMD 

NETUPDT.CHD 

NETHOST.CMD 


- edits the network node list 

- preps the outgoing network message packet for 
another node 

- performs the outgoing call to connect to 
another BBS 

- processes the incoming network message packet 
you received from another system 

- processes incoming network calls 
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Lat ’3 discuss sach .CMD command in detail. 


NETEDIT.CMD - this module runs from the Dos Shell. It allows 
you to enter up to SO different nodes you wish to network 
with Cie receive incoming messages1. This is the only 
module that you will run outside of the event scheduler. 
From the Dos Shell, run the program by typing NETEDIT. The 
following screen will appear: 


CExpressNet OutCail Maintenance! 
ExpressNet Entry *1 

C13 Baud Rate. 300 

C23 Phone Number: 

C33 Incoming Bases 

-+- 1 -+- 2 -+- 


C43 

C53 

C63 

C73 

CB3 


0000000000000000000000000000000 
0000000000000000000000000000000 
Last Bood Call.. 00/00/00 

Max Retries. 10 

Num Retries.0 

User Number.0 

User Pword. 


C#3To Edit CN3ext CD3elete CQ3uit 


CFunction!-> 

# - enter the number of the parameter you want to change. You will 
be prompted as follows: 

Funct^° QglBg tho baud rato and redisplays the screen 
Function 2 

New Phone Number CMax 43 Char.3 
-> 


Function 3 

Edit Ulhich Base Number? -> 20 

Enter the base you want to change. This represents the 
message base number you will be receiving on the other 
system. 

New Base Number? -> OS 

This is the base number on your system where the messages 
from the above option will be pasted. Using the numbers 
in the example, 20 and OS, this translates to 1 want to 
receive base 20 on thim system and I want the meeeagee 
posted on my board in base S’ 

Function S 

New Max Retries CMax 25S3-> 100 

The maximum number of times to retry connecting to the 

board node before giving up. 

Function 6 

Set Num Retries -> 30 

The number of retries before going on to next node entry. 
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Function 7 

Now User Number ■*> 

This ie the user number on the other system that you use 
to logon as a network caller. 

Function 8 

New User Password CMax 15 Char. 3 
-> 

This is the password on the other system that you use to 
logon as a network caller. 


CN3ext - takes you to the next node entry 

CD3elets - will delete and reset the current displayed node entry 

CQ3uit - returns you to the Dos Shell. If any editting was 
performed while NETEDIT ran, the changes are 3aved 
back to NETEDIT.OAT before returning control to Dos 
Shell. 

NETPREP.CMD - this module runs from the event scheduler. 

NETPREP reads the ECHONET.DPT file and builds the "message 
packets’* for each of the node numbers that you have specified 
as being able to receive messages from your board. The NETPREP 
command should be placed in the event scheduler to be run once 
a day. NETPREP simply reads the ECHONET.DPT filB and creates a 
packet Cor file! for each node in the ECHONET file. The "user 
number” specified in the ECHONET.DPT file is actually used to 
read the userlog record so that NETPREP can determine which 

messages are "new” for each node. The user record will be 

updated and rewritten after NETPREP runs. The message packet 
for each node is placBd in the PRO>NET> subdirectory using the 
fallowing data set naming convention: 

X—nn.DPT 
I 

This number will be the NODE number of the 

packet receiver. So, if this packet was built 

for node number 1, the dataset name would be 
X—l.Dat. The node number is derived from the 
first parameter on each line of the 
ECHONET.DPT file. 

NETCPLL.CMD - this module runs from the event scheduler. When 
this event runs, it reads the NETEDIT.DPT file and 3tarts 
calling each board in the list until it connects with the 
board or has tried to call the maximum retries specified. 

Once connected, the boards handshake and start the message 
packet transfer if a packet exists. Once the packet is 
received, the connection is terminated and the receiving 
board passes control to the NETUPDT module to process the 
message packet which has been saved as INCOMING.DPT in the 
network subdirectory. 
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NETUPDT.CMD - this module i3 thB opposite of NETPREP; it applies 
new packets that you have received to your message bases. 
NETUPDT is invoked automatically by the NETCALL.CMD after 
each message packet is downloaded from each board “““ 

are calling. Qnce the packet has been processed, INCOMING.DOT 
is deleted and control is returned to NETCALL to continue the 
calling out process if additional boards still need to be 
called. 


Steps Required To ** RECEIVE •• network message packets: 

1. Run NETEDIT.CMD from the Dos Shell and add the node inf°- 
Remember, you must have a valid logon ID and password to 
the board that you will be receiving these messages from. 

5 Add NETCALL.CMD as an event to the Event Scheduler. Once 

netcall has connected to the board and received the message 
packet, it will hang up and run the NETUPDT module to 
process the packet before continuing with the next entry in 
in the list. Once all the entries have been processed, 
control is returned to the waiting for call module. 


Steps Required To ** SEND *• network message packets: 


1. Add the node entry information to the ECHONET.DAT file 
for the node that will be calling your board to receive 
messages so the message packet for that node will be built 
each day. 


2. You must add a new userlog record for the node that will 
be calling your board. You must toll the sysop of the 
calling board both his user number and password. 

NOTE: Even if the sysop whose board is going to call your 
board already has a user record on your board, you 
MUST create a new user record for his BBS. 


After creating this new user record, you must edit the 
"message base read" security levels far this new record. 
NETPREP mill not echo masgagas from a base that this noae 
does not hBve "read access” to. In other words, you can set 
up a node to only be able to receive messages from bases 
1, 3, 7 and 9. 

Add NETPREP.CMD as an event to the Event Scheduler if it 
is not currently in the event scheduler. NETPREP's Job i3 
to build the message packet for each node you will be 
networking will. When setting up the scheduler, make sure 
that you have scheduled this command to run before you 
expect the first incoming network call. If a network call 
came in and this function had not run, no packet would be 
waiting for that node. 
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It is perfectly acceptable to run the NETPREP every day tp build 
message packets for your networking node’s, but only have the nodes call 
in for messages every other day or even once a week. If NETPREP runs and 
determines that a dataset already exists for a node, it 3imply appends 
the additional messages to the packet. Once the node calls in to receive 
a waiting message packet, the packet will be deleted automatically upon 
a successful transfer with the receiver. 

Should you desire, you may also run the NETPREP module manually 
from thB Dos Shell. Why? Well, suppose you Just started-networking with 
a new node and wanted to get the initial transfer done to make sure 
everything was working correctly before setting it up in AUTO mode. You 
could manually run NETPREP, and have the receiver call in to receive 
(either automatically or using the XHODEfl command from the Dos Shell) 
their message packet. 
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Event Scheduler 


The Event Scheduler allows programs requiring no user input to 
process automatically at predetermined time intervals. The events 

themselves, as well as the time intervals, are set up using Option B in 

the SysEditor. PRO allows you to configure up to 30 of these events to 
run based an the type of event you set it up as. As an example, the 
system automatically configured the WH0I1AINT event to run after every 
call You will recall that WHOtlAlNT is the module that records the 

caller to the last SO callers log. On the master disk are 3 event 

modules excluding the NETWORK modules. 


They are : 

ULBACKUP.CMD 

ULPURGE.CMD 

WHOMAINT.CMD 


backs up your userlag 

deletes users based on lastcall date 

records user to the last 50 callers log when 
they log off the system. This module was 
automatically set up for you when you 
initialized a new Sysdata.Dat file. 

Each of these modules performs a function that does not require any 
input from the sysop to carry out its function. While most of these 
commands could bB executed from the Dos Shell by the 

scheduler removes the burden of remembering to Perform these functions. 
Set them up and forget about them. Let the event scheduler keep track of 
when these modules should be run. 

Normally, after each caller hangs up, as part °f the r eset 
procedure, PRO will start the event scheduler. The event tschedi 
scan the event list, perform each function if it = time. 1snd p 
return control back to PRO. If the board has been idle, Pro will 
automatically start the event scheduler at the top of each hour, so 
events will not be missed due to this idlB time period. This will occur 
frequently in the early morning hours when callers are at a low point. 
This is Ideally when you would want to schedule backups , user log purge 
or packet processing, if you are using the networking facility. 

The scheduling of events is normally a ' eet and *° rl J»t’ 

This is the reason we included the event scheduler in tPo 5 «;j ed | P ° P ’ 
There*is currently no provision for modifying th- -vent schedule «hila 
the board is running. To do this, you have to reset the board and run 
the SuaEditor, then rerun the board. UJo will bo writing an ,__„ r1 nn 
scheduler so this will not be necessary. This module will be placed o 
the support boards for you to download. 
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Library Taxt Manua 


BBS Express I PRO incorporates a text menu structure uihich permits 
the sysop to build selection menus For viewing text Files, executing 
commands or even building a text based adventure game. 

The structure oF these text menus is broken down into 5 sections. 

They are: 1. Command Line 

3. Prompt Line 

3. User Option Selections 

4. END Statement 

5. Text Display 

Hera’s a sample Text-Menu File: 

Text-Menu Level 30 NOABORT Return 
Uiew Which Help File? -”> 

MAIN D1:PRO>TEXT>MAINHELP.TXT 
BASE 01:PR0>TEXT>BASEHELP.TXT 
EDIT Dl:PROTEXTiEDITHELP.TXT 
C/R Exit 
END 

aoo 

Board Help 


CMainl Help On The Main Commands 
CBasel Help On The Message Base Commands 

CEdit] Help On The Message Editor Commands 

<Return> To Exit 

Here’s a sample Command-Menu File: 

Command-Menu Level ao 
Play Which Game? -“> 

Gamel Cards 
Gamea Dungeon 
Game3 Hangman 
Exit Exit 
C/R Score 
END 

aoo 

Online Games 

CGamell Play Cards 

CGameai Play Dungeon 

CGame31 Play Hangman 

CExitl Return To Command Prompt 

<Return> To See The ScoreBoard 


Let’s discuss each section in detail. 

til The Command Line - this line tells PRO how to handle this 
particular text menu. IF more than one parameter is used on this line, 
they should each be separated by a space. The parameters available For 
use on this line are: 
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COMMAND-MENU 


TEXT-MENU 


RETURN 


LEVEL nn 


QUIET nn 


NOABORT 



load and execute the file. Once the command 
executes, the user Is returned to the command prompt. 


this option lets PRO know that,the selection 
options are text files. PRO will display the 
selected file to the user and on the local display 


this option tells PRO to return to this menu uihen 
finished displaying a file. Return only works with 
the text-menu parameter and is only one level deep. 

So if you set up a text menu with a return option, 
and it executes another menu with a return in it, 
the user would return to the second menu. The 
return to the first menu was broken by the second 
menu. Using the same first menu, if a second menu 
is invoked that does not have a return an its 
command line, then the return would be to the first 
menu. 

this option tells PRO to only execute this menu if 
the user's security level is set ON. 'nn' is the 
command level required to execute this menu. If the 
user’s security does not permit them to execute the 
menu, thBy would receive an ’Insufficent Authority’ 
message and would exit back to the command prompt. 

this option functions like the Level nn except that 
if the user does not have the security iBvel 
required to execute the menu, they would be returned 
to the command prompt without receiving any message. 
This is useful if, let’s say, you wanted to alert 
club members to the next meeting date, but didn’t 
want non-club members to know the menu was attempted. 


this option tells PRO to ignore any abort key the 
user may hit and continue displaying the file. This 
is useful if you want the user to read your system 
news EVERY time or have paid advertisements that you 
don’t want the user to be able to abort. 


C21 The Prompt Line - this line allows you to set up the prompt that 
is displayed to the user after the menu display text is presented to the 
user. This allows greater flexibility for requesting user input 
depending on the purpose of your menu. Some example prompts would be: 

Enter Your Selection --> 


CNIorth CSIouth CElast CWlest Which Way? -> 

C31 Thm User Option Selection - this section of the menu con3i3ts of 
the actual filenames for each of the selections available in the menu. 
Each selection in the menu would have a line in this section to 


1. Define the selection mask AND 

B. the filename associated with this selection 
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For instance, let’s use our sample menu which is a menu containing 
user help text files for the board. In this section of the menu, we 
would have 4 entries: 

MAIN Dl:PRO>TEXT>MAINHELP. 

BASE Dl:PRO> TEXT>BASEHELP.TXT 
EDIT D1:PR0>TEXT>EDITHELP.TXT 
C/R Exit 

Looking at the first line, if the user keys the word MAIN, PRO will 
display the text File 01:PRO>TEXT>MAINHELP.TXT. IF the user keys EDIT, 
PRO will display the text file Dl:PRO>TEXT>EDITHELP.TXT. The C/R is a 
special option which allows you to define the action which will be taken 
if the user hits the return key. In this case, we have defined the 
return to be EXIT, but it can be a text file or even another menu. Some 
type of exit must always be defined or the user would never be able to 
get out the the menu. In the sample menus above, we have shown you 2 
ways to code in an exit. Either using the C/R as an exit or explicitly 
coding the word EXIT as an option. 

When building a Text-Menu, the FULL pathname must be specified 
including the drive, subdirectory and Filename. If you are building a 
Command-Menu, only the 0 character filename is specified. PRO will 
always build the full pathname by adding the .CMD to the filename you 
specified and will always go to the PRO>COMMANOS> subdirectory to find 
the File to execute. 

You may also pass parameters to a command from a Command-Menu (if 
the command can take parameters). For instance: 

Command-Menu Level 32 
Download Which File? --> 

Call Xmodem S Dl:PRO>LOG>Call.Log 
ULog Xmodem S Dl:PRO>Userlog>Userlog.Rpt 
Exit Exit 
END 
800 

Download Board Reports 
Co-Sysop’s Only 

CCalll Download Call Log 
CUlogl Download Userlog Report 
CExitl Exit This Menu 

In the above example, the Xmodem command requires 2 parameters be 
passed to it. The first parameter 'S’ tells xmodem to send a file and 
the second parameter is the filename to send. 

C43 END - this parameter terminates the structured menu information 
from the text display which follows. Everything after this statement to 
the end of the menu File is displayed to the user. This END parameter 
MUST be present in the menu or the menu will not work correctly. 

tSl Text Display - this is the portion of the menu which is displayed 
to the user. Uariable tags may be used in this section of the menu. In 
our sample, we used the 800 variable tag to clear the screen beFore 
displaying the menu to the user. 
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Main Msnu Command* 


Beloui aro tha commands available to the user at the main command 
prompt. These are the commands set up by default. You may add or delate 
commands as you wish. Refer to the section on the Syseditor for the 
proper procedure for adding main commands. Note that the Ushell function 
is provided only if you would like your users to see what can be 
performed in the Dos Shell. The only real change a user could make using 
the User Dos Shell would be to turn chat OFF and ON. Any other function 
which could do damage has been turned off. Should you decide that you 
don't want your U 3 ers to see the DEMO, this function may be removed from 
the menu and main command list. 

BBS Expressl Professional 
Main Menu 

(Upload Your Files Under CBTrowsel) 


• A ASCI I/ATASCII I B Browse Files 

• C Call Sysop I D D/l Locator 

• F Feedback Area ! G Goodbye (Off) 

• I System InfoNETI L Library Files 

• N System News ! 0 Ordering Form 

• P Parameter Edit! R Read “E-Mail* 

• S Send *E-Mail* ! U User Search 

• td Last 50 Calls ! Y Your Own Stats 

• - GoTo Any Base ! • Msg Base List 

» Q Ouickscanl ! 0 Edit scan list 

• * Shell >0emo< ! t S1G Statistics 


• ft - On-Line Upload Ualidator 

• \ - On-Line User Editor 

• s - SysOp-Only DOS Shell 


Message Base Commands 

The Following is a list of commands available to the user when they 
are in a message base. 

<Return! reads the next message 

CA] Read the current message again — COT Quit reading current thread 

CB3 Set read direction to backward *-*CR] Reply to the current message 

I CC] Continue keyword search " CS] See replies to current message 

CD] Delete the current message ! CT] See thread of current message 

CE] Edit the current message I CU] Unlock the current message 

CF] Set read direction to forward ICU] Uerbose mode toggle (on/ofF) 

CG] Goto a certain message number > CX] Exit back to the main menu 

CJ] Goto a certain message number 1 C*] List of active message bases 

CK] Search for a keyword * C0] Add/remove base from scan list 

1 CL] Lock the current message - [ + J Read ahead one message 

CM] Message base statistics ■ ’C-] Read back one message 

- CN] Position at first new message 1 C>) Read ahead one message 
CP] Post a new message 1 C<] Read back one message 

If verbose is OFF, hitting 'A' will read the message 

Two additional commands are available to the sysop: 

CH] HardCopy Print CZ] Change name of message base 
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Editor Commands 


The Fallowing ia a list oF commands availabla to the user in the 
massage editor. Each of these commands is proceeded by a /in the 
First position oF a line. 


CA3 Abort this message and exit 
CB3 Begin this message over again 
CC3 Display a columnar heading 
CE3 Edit an individual line 
CF3 Formatted listing oF message 
CG3 Toggle graphics mode on / oFF 
C13 Insert a new line 


CL3 List the message 
CN3 List the message with numbers 
CR3 Repeat the last input line 
CS3 Save this message and exit 
CL13 UnFormatted Save and exit 
CU3 Toggle word wrap on and oFF 
C/3 Clear the screen 


Ualid Control Keys 

-L - Paste Letter From saved line ‘UI - Paste Word From saved line 

-N - Inserts your Name Chandle) 'R - Inserts your Real name 


File BIG Commands 

The Following is a list oF commands available to the user when they 
are in a File slg area. 

CB3 Browse Flies with descriptions 
CC3 Catalog Files, IS per page 
CN3 New Files since your last call 
CU3 Upload a new File 
C/3 Go to the next File area 
C-3 Go to another File area 
CX3 Exit to the main menu 


Adding System Commands 

System commands can be Bddad at any time by simply Mpyinj the .CMD 
File into your command subdirectory. By doing this, they are immediately 
available to the sysop From the Dos Shell. IF it is a command File that 
will be used by your board users, you will need to deFine the * n 
the sysdata File by using the syseditor and editing the main commands. 
ReFer to the section on the Syseditor For the proper procedure For 
adding main commands. 
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Starting Tha Board 

Ok. . .noui that uie have everything configured, we’re ready to run the 
board. But first, a checklist. 


1. Subdirectories created f nm) 

2. Sysdata.Dat configured Cmust be in path you boot the BBS from) 

3. Userlog created 

4. Message Bases created 

5. File Sig directories created 

6. Help files created and/or edited 

7. Modem configured __. , 

TDLINE installed (manually or from the Startup.Bat) 

RS232 installed (manually or from the f *; ar *; u P' 

BBSPREP installed (manually or from the Startup.Bat) 


8 . 

3 . 

10 . 


now we 1 11 run the BBS.COM program from 


Ok, everything checks out. 
the PR0> directory. 

If this is the first time you have run the board, several things 
must be done before you’re ready for the first caller. First you need 

S the userlog^ “ a * ' 

having 3 a SEy£* ^b^Hre^ ISVn ^ferentlS then 

other ID'S, so these must never be used by regular users. 


They are: 


U 3 er ID's 1 through 3 are reserved by the system. 

ID #1 is the 'Visitor record' 

ID #2 is the ’New User record' 

Id’s 3 thru 3 are sysop predefined validation masks 

Now, you will need to edit tha Uisitor record and the New User 
record to set up the following: 

time limits 
download ratios 
command security levels 
message base security levels 
file sig security levels 

Ulhen a new user calls and asks for a permanent ID, these are the 
initial values that will be transferred to their ID until you validate 
them. The rest of the data is obtained from the user when they apply fo 
an ID. 

Ue recommend that VISITORS not be allowed to post messages. Just 
let them read messages and look around. 

The ID’s 3 thru 3 are special validation mask ID'S (1-7) that the 
sysop can set up to aid in the validation of new users. Many of you 
currently running boards tend to validate new users in one of a ^"j u 
of ways, depending on the user information supplied. You can pradef 
up to 7 of these validation masks so that when you areuser's ID By 
user uou can apply one of these validation masks to that user s . y 
doing this all the command, message and file security levels B 

the time limits and download ratio set in that particular validation 
mask are transposed to the user record that you are currently editing. 
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Rathar than individually setting all tha security flays by u °“ can 

APPLY a generic security level far this user by pressing Just one key. 


You will notice when the BBS 
the top of the screen. This is the 
time you may want or need to see 
status lines. By holding down the 
•a’, ’3’ or '4’, you can change the 
uindou. 


starts, the 6 line Status Uindou at 
normal configuration. From time to 
more of the screen uithout all the 
SHIFT CONTROL keys and pressing '1’, 
number of lines used for the status 


SHIFT CONTROL 1 - displays the normal 6 line status uindou 
SHIFT CONTROL 2 - displays a 4 line status uindou 
SHIFT CONTROL 3 - displays a S line status uindou 
SHIFT CONTROL 4 - no status uindou 


Sysop Options From Halting For Call 

There are B options available to the sysop uhile the board is 
uaiting for a call. They are: 


1 Quick Entry #1 
3 Quick Entry #2 

3 Logon By Handle 

4 Logon By Name 

5 Normal Logon 


S User Editor 
7 Chat Mode 
S DOS Shell 


1. Quick Entry 41 - this logon option allous the sysop CUser #103 to 
quick logon directly to the command prompt. Logon using this 
option sets the last caller to 'A Uisitor 1 . 

а. Quick Entry 42 - this logon option allous a co-sysop (user #113 to 

quick logon directly to the command prompt. Logon using this 
option sets the last caller to ’A Uisitor’. 

3. Logon By Handle - this logon option allous logon directly to the 

command prompt as a user after supplying the users handle. Logon 
using this option updatss tha last callar. 

4. Logon By Name - this logon option allous logon directly to the 

command prompt as a user after supplying the users real name. 
Logon using this option updates the last caller. 

5. Normal Logon - this option allous logon as if you uere connected 

remotely. All the normal logon files are displayed and all 
prompts for logon data are made and validated. 

б. User Editor - this option allous you to access the user editor 

uithout the need to logon to the system. 

7. Chat Mode - this option toggles the chat mode ON and OFF. Chat 
mode status is visible in the BBS status uindou. 

B. DOB Shell - this option allous you to access the DOS Shell 
uithout the need to logon to the system. 
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Entering Chat Mode 

While a caller ie online, you may enter chat mode by pressing the 
escape key once. You are then placed in a direct chat mode with the user. 
Typing From the local keyboard will immediately be output to the modem 

as you type, A unique Feature oF PRO'S chat mode is IF you press the 

escape key a second time, a type ahead buFFer uiill appear in the bottom 
5 status lines. You can now type a message to the user while they are 

typing to you, but your message will not be sent out until you press the 

enter key. Once you press the enter key, you are immediately back in 
real time chat mode. Pressing escape again will turn on the type ahead 
buFFer again For your next message. This Feature can came in handy if 
you are in chat mode with a slow typist and you know the answer you want 
to send beFora the caller has even Finished asking the question. Just 
press escape again, key your response and wait For them to Finish typing 
beFore pressing the enter key to send your response. Your users will be 
amazed at how Fast a typist you arel 

To EXIT chat mode, simply press ESCape twice. 


The Syetea Clock 


The BBS system clock is actually using the SpartaDOS soFtware clock 
which is normally set manually or automatically set iF you have the 
R-Time B clock cartridge. In either case. BBS ExpressI PRO requires that 
TDLINE.COM handler be installed beFore running the BBS. An error will 
occur and PRO will reFuse to load iF the TDLINE handler is not installed. 


The Call Log 


The system call log is stored in the PR0>L0G> subdirectory using 
the name CALL. LOG. Each caller to the BBS is logged into this dataset. 
Call.Log does not have to be predeFined. IF PRO can not Find 
dataset will automatically be created. 


it, the 


The Call.Log may 
drive number to 0 using 


be disabled iF you choose, 
the SysEditor. 


by setting the LOG 
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User Editable Parameters 


When a usBr presses tha P key to adit thair user settable 
parameters, they are presented with the following: 


CAT 

Real Name 

John Doe 


CB3 

Handle 

JD 


CCD 

Address 

1234 Any Street 


CD3 

City 

Midlothian, UA 


CE3 

Zip Code 

23113 


CF3 

Country 

USA 


CG3 

Phone 

373-4156 


CH3 

Computer 

Atari (all) 


C 13 

Age 

30 


CJ3 

Password 

atari 


CK3 

g. Width 

40 


CL3 

Auto-read 

Email at logon: 

No 

CM3 

Clear screen after msg 

Yes 

CN3 

"Hotkey” 

1-key commands : 

Yes 

COD 

Non-stop 

quickscan mode : 

No 

CP3 

Message view page length: 

0 


Enter letter to change, OK when done, 
or <return> to list: 


Any of these settings may be set by the user (except changing their 
name/handla) and are stored in tha users record. PRO uses these settings 
when making decisions on how to present the data to the user. 


Logging A Uaer O-f-f The Syatee 

At any time a caller is online, you may hang them up instantly by 
pressing the START SELECT OPTION keys simultaneously. This will 
terminate the call and reset the board back to the waiting for call 
screen. 


Converting 830/1030 Express! Userlog To PRO 


Ue had originally intended to provide a conversion program for 
owners of the S50/1030 original versions of BBS Express! for 
converting their existing userlog to the PRO format. Halfway through the 
code, we realized that only the handle, password, city and state could 


converted to the new format. This does not come close to the information 
that is now stored with each userlog record. Therefore, we concluded 
that the sysop could spend weeks trying to hand key a11 .tj? 
required, assuming they had it in the first place. We scrapped the plan 
in the name of progress. 


In the long run, your userlog will provide you “^ h more 
information and be more accurate if you ask your users to log 
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Printing And Purging The User Log 


Thera ere S .CMD 
printing end purging 


modules available on the disk for the purpose of 
the userlog. They are: ULPRINT.CMD and ULPURGE.CMD 


ULPRINT.CMD is a command module that can only ba run from the Dos 
Shell by typing ULPRINT. It has 4 options available: 


1. Print Userlog To Printer - mill print the userlog C4 
users per page) to the printer. 


a. Print Userlog To Disk File - will write the userlog 

report to a disk file instead of the printer. You will 
be prompted for a FULL filename at the time you 
execute this function. This can be useful For remote 
sysops, they can download the created File and copy 
it to their printer or for the sysop to print the 
userlog on another system that has a printer 
connected. The output from this option is the same as 
in option 1 except it goBS to a disk file rather than 
the printer. 


3. Print Only New Users - will print only the users in the 

userlog who currently have a status of 'New User . 

This can be useful for printing new users since the 
last time you validated users, BEFORE validating them. 
Output from this option is directed to the printer. 

4. View Userlog Statistics - will scan the userlog and 

display to the screen Clocally and remotely) the 
current userlog statistics as follows: 


System Reserved : x 

Active Users : xxxxx 
Locked Users : xxxxx 
New Users : xxxxx 
Deleted Users : xxxxx 
Total Users : xxxxx 


This can be useful for determining the status of your 
userlog and to see if new users have called since your 
last validation or if the userlog is approaching its 
maximum allocation. 


ULPURBE.CMD is a command module that can be run from the Dos Shall 

by typing ULPURGE, or it may be set up as event to be run by the Event 

Scheduler. 

When ULPURGE runs, it looks for a file called ULPURGE.DAT in the 
PRO>DATA> subdirectory. This file is a text File containing 11i. 
that line is a number between 1 and 365 which represents the number of 
days back from the current date to start purging. 

Let's say you want to delete users who have not called U°ur board 

in the last 30 days. Create the file called ULPURGE.DAT in the PRO>DATA> 
subdirectory. On the First line, key in 90, followed by a ‘•■turn, and 
save the File. Now whan ULPURGE.CMD runs, it will read the ULPURGE.DAT 
and use 90 as its days to purge value. It will read the userlog 
any user who has not called in the last 90 days as deleted. ULPURGE 
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mill bypass any usar record you have lacked regardless of the last call 
date, so locked users mill never be delated. 

The Important thing to remember here is that once you establish 
your purge days, you never have to change. ULPURGE mill always calculate 
the purge date based on the current date and your purge days criteria. 
While you can run this program as often as every call, uia suggest you 
use it as an event and set it up to run once a week. 


Other Utility Program* 

ULBACKUP.CMD is a command module that can be run from the Dos Shell 

by typing ULBACKUP while in the Dos Shell or it may be set up as event 

to be run by the Event Scheduler. When ULBACKUP runs, it looks for a 
file called ULBACKUP.OAT in the PRO>DATA> subdirectory. This file is a 
text file containing 1 line. On that line is the FULL filename to be 
used as the destination filename for backing up the userlog and is 
terminated by a return. Us suggest you set up your filename to backup 
to the same directory as your userlog using the the name USERLOG.BAK. 
So, assuming your userlog is on drive 3, ULBACKUP.DAT mould contain one 
line rnith the filename D2iPR0>USERL0G>USERL06.BAK followed by a return. 
How often you run the ULBACKUP is a function of where you have your 
userlog located. If it’s on the hard drive or a floppy drive, once a 
day or once a week is probably fins. If you run the userlog out of a 
ramdisk, you might consider setting ULBACKUP to run after every call. 

Then if you lose power, you really haven't lost anything. Uhen the 

power comes back on, recopy the userlog back to the ramdisk and you're 
back in business. 

MHOMAINT.CMD is a command module that records the caller to the 
last SO callers log which users can view using the WHOCALL.CMD module. 
By default, this module was automatically set up when you configured 
your sysdata.dat file to be the first event to run and will always run 
after every call. To insure the accuracy of your lastcall data file, we 
suggest you run it like this unless you do not wish to use the last call 
function on the board, in which case this module may be removed from the 
event scheduler. MHOMAINT will not record the logon of user number 10 
(Sysop) or user number 11 (Co-Sysop) when they logon either locally or 
remotely. This is so you or your co-sysop may enter your BBS without the 
users being aware of the fact. The actual data filename is LASTCALL.DAT 
and is stored in the DATA subdirectory. This file does not need to pre¬ 
exist. UIHOflAINT will create a new file if it cant find one. Should you 
ever need or want to, LASTCALL.DAT may bo deleted without any ill 
effect. WHOMAINT will simply create a new one the next time it runs. 

D.CMD is a command module which is an alternate to the Dos Shell’s 
internal DIR command. D will list the files 3 to a line instead of the 
usual 1 per line. 

EDITFILE.CMD is a command module which is used to edit text files 
while the BBS is running. EditFils is capable of editing a 355 line text 
file of up to BO columns. EditFile is run From the Dos Shell by entering 
the module name. You may pass the filename as a parameter to EditFile or 
just be prompted For a filename by entering the module name. 
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VDEL.CMD is a command modula which will ask for verification before 
deletion the file. It may be used an an alternate to the Dos Shell’s 
internal ERASE and DELETE commands which do not ask for verification 
before deleting the file. 

MHEREI8.CMD is a command modula to be run from the Dos Shall which 
will locate a file or files based on the input filemask any where on the 
drive. For instance, keying a filemask D3i>I.ARC would locate all files 
on drive 3 with an extender of ARC regardless of which subdirectory they 
were in. 

VIEWEVNT.CMD is a command module to be run from the Dos Shell which 
will display the last run status of the event scheduler. It will list 
each event and the last date/time it was run with the a return code run 
status. A run status of 0 indicates the event ran successfully while a 
non zero return code indicates an error occured during execution. The 
error cods will be a DOS return code. For example, a return code of 170 
would indicate the event was looking for a file which it could not find. 

UEXTEND.COM is a stand alone program to be used for extending your 
userlog. No matter how well you plan, the time may come when you run out 
of ID’s in your ussrlog. UEXTEND will increase the current userlog by an 
additional number of entries that you specify when running the program. 
This program modifies the original userlog, so only 1 drive is required 
to perform this operation. Bat, make sure you have a backup of the 
userlog before running this program. If something should happen like the 
drive fills up while the program Is running, you can recover by copying 
your backup copy to the original userlog and try again. Run this program 
from the DOS prompt and follow the program prompts. 

XMODEM.CMD is a command moduis available to the sysop for use 
directly in the Das Shell or in Command Menus. The command syntax is: 

Xmodem CS or R] Filename 

S - tells PRO to SEND the file 
R - tells PRO to RECEIUE the file 

Filename - is the FULL pathname of the file. 
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Where To Got Halp 


In the event you need help configuring your BBS or need a question 
answered, you may call us voice at 804-794-9437 during evening hours 
C B P.H. to 11:00 P.fl. EST ) or anytime during the weekend. Please tie 
ready to give your serial number for verification before we can answer 
any questions. We will be glad to help any of our customers with the BBS, 
but absolutely refas* to assist a pirate of our products. 

While on the subject of pirating, we ask that you not give a copy 
of our software products to anyone . We realize that for the vast 
majority of you, we don’t even have to ask and we appreciate that. But, 
if one of you gives a copy out to a friend, before you know it, it s o 
every pirate board in the country. We would like to continue supporting 
the U Atari B-bit market in the future, and not giving out the programs 
ensures we will be around for many years to came with more products. 

In addition, you may call one of the following BBS systems for 
support: 


BBS Expraam! PRO Support BBS 
Midnight Express BBS 


804-744-8897 3/12/24 24 hours 
804—379—4134 3/12/24 24 hours 


Both these systems will have special message bases and file areas 
set aside for the exclusive user of registered owners. When calling 
these systems, leave your serial number in feedback to the sysop so y 
may validate you for these special areas. Pa upgrades occur and new 
modules are written, they will be placed on both these •£*»*“* 
to download. It is up to you to check in periodically for upgrades or 
new modules. Both systems will have the same modules online, so it is 
not necessary to call both systems to get all the upgrades. 


Transferring Ownership 

We will transfer the ownership of your master disks to someone else 
if you decide to sell your copy. We need to be notified by you of this 
fact. If the new owner calls us for support (voice or BBS we will not 
be able to offer support until the original owner notifies us of the 
transfer. A call to either support board, leaving email to the =y= P 
will be sufficient, or a letter to Orion Micro Systems notifying us of 
the* transfer.Once we have received notification the new owner -ill 
receive the same support as if they had purchased the program directly 
from us. 
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